<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>clear_obj [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_object.html">Object</a> / <a href="toc_object_manipulation.html">Manipulation</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">clear_obj</span><span data-if="c" style="display:none;">clear_obj</span><span data-if="cpp" style="display:none;">ClearObj</span><span data-if="dotnet" style="display:none;">ClearObj</span><span data-if="python" style="display:none;">clear_obj</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">clear_obj</span><span data-if="c" style="display:none;">clear_obj</span><span data-if="cpp" style="display:none;">ClearObj</span><span data-if="dotnet" style="display:none;">ClearObj</span><span data-if="python" style="display:none;">clear_obj</span></code> — Delete an iconic object from the HALCON database.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>clear_obj</b>(<a href="#Objects"><i>Objects</i></a> :  :  : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>clear_obj</b>(const Hobject <a href="#Objects"><i>Objects</i></a>)</code></p>
<p>
<code>Herror <b>T_clear_obj</b>(const Hobject <a href="#Objects"><i>Objects</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ClearObj</b>(const HObject&amp; <a href="#Objects"><i>Objects</i></a>)</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ClearObj</b>(<a href="HObject.html">HObject</a> <a href="#Objects"><i>objects</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>clear_obj</b>(<a href="#Objects"><i>objects</i></a>: HObject) -&gt; None</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">clear_obj</span><span data-if="c" style="display:none">clear_obj</span><span data-if="cpp" style="display:none">ClearObj</span><span data-if="com" style="display:none">ClearObj</span><span data-if="dotnet" style="display:none">ClearObj</span><span data-if="python" style="display:none">clear_obj</span></code> deletes iconic objects, which are no longer
needed, from the HALCON database.  It should be noted that
<code><span data-if="hdevelop" style="display:inline">clear_obj</span><span data-if="c" style="display:none">clear_obj</span><span data-if="cpp" style="display:none">ClearObj</span><span data-if="com" style="display:none">ClearObj</span><span data-if="dotnet" style="display:none">ClearObj</span><span data-if="python" style="display:none">clear_obj</span></code> is the only way to delete objects from the
database, and hence to reclaim their memory, in HALCON/C.  In all
other HALCON language interfaces, <code><span data-if="hdevelop" style="display:inline">clear_obj</span><span data-if="c" style="display:none">clear_obj</span><span data-if="cpp" style="display:none">ClearObj</span><span data-if="com" style="display:none">ClearObj</span><span data-if="dotnet" style="display:none">ClearObj</span><span data-if="python" style="display:none">clear_obj</span></code> <b>must
not</b> be used because objects are destroyed automatically through
appropriate destructors.
</p>
<p>Images and regions are normally used by several iconic objects at
the same time (uses less memory!).  This has the consequence that a
region or an image is only deleted if all objects using it have been
deleted.
</p>
<p>该算子 <a href="reset_obj_db.html"><code><span data-if="hdevelop" style="display:inline">reset_obj_db</span><span data-if="c" style="display:none">reset_obj_db</span><span data-if="cpp" style="display:none">ResetObjDb</span><span data-if="com" style="display:none">ResetObjDb</span><span data-if="dotnet" style="display:none">ResetObjDb</span><span data-if="python" style="display:none">reset_obj_db</span></code></a> can be used to reset the system
and clear all remaining iconic objects.
</p>
<p>For a short description of the iconic objects that are available in HALCON
see the introduction of chapter <a href="toc_object.html">Object</a>.</p>
<h2 id="sec_attention">注意</h2>
<p>Regarding the use of local variables in HALCON/C: When exiting a subroutine,
the local variables are deleted, but the HALCON database is not updated. To
update the database and thus free the memory, you must explicitly clear the
local objects from the database before exiting the subroutine.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Objects" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Objects</span><span data-if="c" style="display:none">Objects</span><span data-if="cpp" style="display:none">Objects</span><span data-if="com" style="display:none">Objects</span><span data-if="dotnet" style="display:none">objects</span><span data-if="python" style="display:none">objects</span></code></b> (input_object)  </span><span>object(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Objects to be deleted.</p>
</div>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">clear_obj</span><span data-if="c" style="display:none">clear_obj</span><span data-if="cpp" style="display:none">ClearObj</span><span data-if="com" style="display:none">ClearObj</span><span data-if="dotnet" style="display:none">ClearObj</span><span data-if="python" style="display:none">clear_obj</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all objects are contained in
the HALCON database.  If not all objects are valid (e.g., already
cleared), an exception is raised, which also clears all valid objects.
该算子 <a href="set_check.html"><code><span data-if="hdevelop" style="display:inline">set_check(::'~clear':)</span><span data-if="c" style="display:none">set_check("~clear")</span><span data-if="cpp" style="display:none">SetCheck("~clear")</span><span data-if="com" style="display:none">SetCheck("~clear")</span><span data-if="dotnet" style="display:none">SetCheck("~clear")</span><span data-if="python" style="display:none">set_check("~clear")</span></code></a>
can be used to suppress the raising of this exception. If the input is
empty the behavior can be set via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'no_object_result',&lt;Result&gt;:)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>.
如有必要，将引发异常。</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="reset_obj_db.html"><span data-if="hdevelop" style="display:inline">reset_obj_db</span><span data-if="c" style="display:none">reset_obj_db</span><span data-if="cpp" style="display:none">ResetObjDb</span><span data-if="com" style="display:none">ResetObjDb</span><span data-if="dotnet" style="display:none">ResetObjDb</span><span data-if="python" style="display:none">reset_obj_db</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="set_check.html"><span data-if="hdevelop" style="display:inline">set_check</span><span data-if="c" style="display:none">set_check</span><span data-if="cpp" style="display:none">SetCheck</span><span data-if="com" style="display:none">SetCheck</span><span data-if="dotnet" style="display:none">SetCheck</span><span data-if="python" style="display:none">set_check</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
